package com.superman.mvpframe.client.utils;

import java.math.BigDecimal;

/**
 * 数学工具类 提供加减乘除 四舍五入
 * 
 * @author superman
 * @version 2013-12-17下午3:05:03
 */

public class MathUtil {

	private static final int DEF_DIV_SCALE = 2; // 小数点后精确的位数

	/**
	 * 提供精确的加法运算,保留小数点后两位
	 * 
	 * @param v1 被加数
	 * @param v2 加数
	 * @return 两个参数的和
	 */
	public static String add(String v1, String v2) {
		return add(v1, v2, DEF_DIV_SCALE);
	}

	/**
	 * 提供精确的加法运算。
	 * 
	 * @param v1 被加数
	 * @param v2 加数
	 * @param scale 表示表示需要精确到小数点以后几位
	 * @return 两个参数的和
	 */
	public static String add(String v1, String v2, int scale) {
		BigDecimal b1 = new BigDecimal(v1);
		BigDecimal b2 = new BigDecimal(v2);
		return round(String.valueOf(b1.add(b2)), scale);
	}

	/**
	 * 提供（相对）精确的除法运算，当发生除不尽的情况时，精确到 小数点以后2位，以后的数字四舍五入。
	 * 
	 * @param v1 被除数
	 * @param v2 除数
	 * @return 两个参数的商
	 */
	public static String div(String v1, String v2) {
		return div(v1, v2, DEF_DIV_SCALE);
	}

	/**
	 * 提供（相对）精确的除法运算。当发生除不尽的情况时，由scale参数指 定精度，以后的数字四舍五入。
	 * 
	 * @param v1 被除数
	 * @param v2 除数
	 * @param scale 表示表示需要精确到小数点以后几位。
	 * @return 两个参数的商
	 */
	public static String div(String v1, String v2, int scale) {
		if (scale < 0) {
			throw new IllegalArgumentException("The scale must be a positive integer or zero");
		}
		BigDecimal b1 = new BigDecimal(v1);
		BigDecimal b2 = new BigDecimal(v2);
		return String.valueOf(b1.divide(b2, scale, BigDecimal.ROUND_HALF_UP));
	}

	/**
	 * 提供精确的乘法运算,保留小数点后两位
	 * 
	 * @param v1 被乘数
	 * @param v2 乘数
	 * @return 两个参数的积
	 */
	public static String mul(String v1, String v2) {
		return mul(v1, v2, DEF_DIV_SCALE);
	}

	/**
	 * 提供精确的乘法运算。
	 * 
	 * @param v1 被乘数
	 * @param v2 乘数
	 * @param scale 表示表示需要精确到小数点以后几位
	 * @return 两个参数的积
	 */
	public static String mul(String v1, String v2, int scale) {
		BigDecimal b1 = new BigDecimal(v1);
		BigDecimal b2 = new BigDecimal(v2);
		return round(String.valueOf(b1.multiply(b2)), scale);
	}

	/**
	 * 提供精确的小数位四舍五入处理。
	 * 
	 * @param v 需要四舍五入的数字
	 * @return 四舍五入后的结果
	 */
	public static String round(String v) {
		return round(v, DEF_DIV_SCALE);
	}

	/**
	 * 提供精确的小数位四舍五入处理。
	 * 
	 * @param v 需要四舍五入的数字
	 * @param scale 小数点后保留几位
	 * @return 四舍五入后的结果
	 */
	public static String round(String v, int scale) {
		if (scale < 0) {
			throw new IllegalArgumentException("The scale must be a positive integer or zero");
		}
		BigDecimal b = new BigDecimal(v);
		BigDecimal one = new BigDecimal("1");
		return String.valueOf(b.divide(one, scale, BigDecimal.ROUND_HALF_UP));
	}

	/**
	 * 提供精确的减法运算,保留小数点后两位
	 * 
	 * @param v1 被减数
	 * @param v2 减数
	 * @return 两个参数的差
	 */
	public static String sub(String v1, String v2) {
		return sub(v1, v2, DEF_DIV_SCALE);
	}

	/**
	 * 提供精确的减法运算
	 * 
	 * @param v1 被减数
	 * @param v2 减数
	 * @param scale 表示表示需要精确到小数点以后几位
	 * @return 两个参数的差
	 */
	public static String sub(String v1, String v2, int scale) {
		BigDecimal b1 = new BigDecimal(v1);
		BigDecimal b2 = new BigDecimal(v2);
		return round(String.valueOf(b1.subtract(b2)), scale);
	}

}
